Circuit Breaker policy

Updated 23 July 2026

With the Circuit Breaker policy, you can define failure thresholds. When the threshold is met, you can redirect or fail with a 503 Service Unavailable error.

note

If you apply the Circuit Breaker policy to an API, it takes precedence, and the system ignores the max retry attempts configured in execution settings.

Timing

On Request	On Response
X

Configuration

Property	Required	Description	Type	Default
failureRateThreshold	yes	Failure rate threshold before the circuit breaker switches to open state. A failure represents a response status code greater than or equal to 500. The system expresses the threshold as a percentage.	integer (minimum 0, maximum 100)	50
slowCallRateThreshold	yes	Slow call rate threshold before the circuit breaker switches to open state. A response time greater than the configured slowCallDurationThreshold represents a slow call. The system expresses the threshold as a percentage.	integer (min. 0, max.100)	50
slowCallDurationThreshold	yes	The duration threshold above which the system considers a call slow, increasing slowCallRateThreshold. The system expresses the duration in milliseconds.	integer (minimum 1)	1000
windowSize	yes	The size of the sliding window that records the outcome of calls when the circuit is closed.	integer(minimum >0)	100
waitDurationInOpenState	yes	The duration in milliseconds before switching from open circuit to half-open.	integer (minimum 1)	1000
redirectToURL	no	Redirect the call to the given URL instead of returning 503 Service Unavailable status (supports Expression Language)	string
headers	no	Append additional headers to the redirect request.	array

Example

{
  "failureRateThreshold": 50,
  "slowCallRateThreshold": 50,
  "slowCallDurationThreshold": 1000,
  "windowSize": 100,
  "waitDurationInOpenState": 1000,
  "redirectToURL": "",
  "headers": [
        {
            "name": "Content-Type",
            "value": "application/json"
        }
    ]
}